home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #2 / Monster Media No. 2 (Monster Media)(1994).ISO / math / kstat33.zip / KSSPIN.DOC < prev    next >
Text File  |  1994-07-01  |  16KB  |  415 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.           
  7.           
  8.           
  9.                                    TexaSoft's
  10.           
  11.           
  12.                            KWIKSTAT Supplement Manual
  13.           
  14.                           Spin Plot, Data Visualization
  15.                                       3.3
  16.           
  17.           
  18.           
  19.           
  20.           (C)Copyright 1993 Alan C. Elliott
  21.           
  22.           For additional information on this product, contact
  23.           TexaSoft, P.O. Box 1169, Cedar Hill, Texas 75104 (214)
  24.           291-2115, Fax: (214) 291-3400, Compuserve:70721,3145.
  25.           
  26.           ACKNOWLEDGMENTS
  27.           
  28.           Production team: Alan Elliott, Paul Witt, Carol Bigler,
  29.           Nancy Witt.
  30.           
  31.           ALL RIGHTS RESERVED
  32.           
  33.           All rights reserved. Printed in the United States of
  34.           America. No part of this book may be reproduced without
  35.           prior permission. For information, address TexaSoft, P.O.
  36.           Box 1169, Cedar Hill, Texas  75104. No patent liability is
  37.           assumed with respect to the use of the information
  38.           contained herein. While every precaution has been taken in
  39.           the preparation of  this publication, the publisher assumes
  40.           no responsibility for errors or omissions. Neither is any
  41.           liability assumed for damages resulting from the use of the
  42.           information herein.
  43.           
  44.           INSTALLATION
  45.           
  46.           To install the KWIKSTAT SPIN module, you must have already
  47.           installed the KWIKSTAT BASIC edition. Then, place the SPIN
  48.           disk in drive A (or B). Make A (or B) the default drive by
  49.           Entering A: (or B:). Enter the command INSTALL, and follow
  50.           the instructions on the screen.
  51.           
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.                                            1
  60.  
  61.  
  62.  
  63.  
  64.  
  65.           
  66.           KWIKSTAT 3D Scatterplot/SPIN
  67.           ----------------------------------------------------------
  68.           
  69.           
  70.                          KWIKSTAT 3D DATA VISUALIZATION
  71.           
  72.                                     SPIN PLOT
  73.           
  74.           INTRODUCTION
  75.           
  76.           The KWIKSTAT "SPIN" module allows you to interactively view
  77.           three dimensional scatter plots. The SPIN Graph menu
  78.           contains two parts, separated by a horizontal bar. The top
  79.           item allows you to choose to display the spin plot. The
  80.           bottom part of the menu allows you to choose other options,
  81.           including the ability to choose a database to open, edit
  82.           information in the currently opened database, select a
  83.           previously saved .GRF file to redisplay, and end the
  84.           program.
  85.           
  86.           3-DIMENSIONAL INTERACTIVE SCATTER PLOTS
  87.           
  88.           The Three Dimensional Interactive Scatter Plot (Spin plot)
  89.           allows you to visualize your data, rotate the plot along the
  90.           x, y, or z axes, spin the data, and choose other display
  91.           options. When you choose the 3D XYZ Data visualization plot
  92.           option from the SPIN Plot menu, you are prompted to choose
  93.           three numeric fields.
  94.           
  95.           These three fields should contain the three numeric
  96.           variables whose relationship you wish to view. You may also
  97.           optionally choose a grouping variable. When a grouping
  98.           variables is used, the points on the plot will be displayed
  99.           where points for each different group (up to 10 groups) will
  100.           appear in different colors or points for different groups
  101.           will be displayed using a different shaped point (such as a
  102.           circle, square, diamond, etc.) Once you have chosen the
  103.           fields, an initial plot appears.
  104.           
  105.           The plot in this figure is displaying information from the
  106.           CAR.DBF database, using the fields MPG, WEIGHT and HP and
  107.           the grouping field CYLINDERS. Options (menu on the right)
  108.           available for the Spin plot are Manually rotate the plot
  109.           (up-, down-, left- and right-arrow, PgUp and PgDn keys) by
  110.           choosing Roll, Pitch or Yaw. Either point to one of these
  111.           options with the mouse and click, or press the designated
  112.           keyboard button to choose one of these options.
  113.           
  114.           Automatically spin the plot by pressing CTRL, plus a Roll,
  115.  
  116.  
  117.  
  118.                                            2
  119.  
  120.  
  121.  
  122.  
  123.  
  124.           
  125.           KWIKSTAT 3D Scatterplot/SPIN
  126.           ----------------------------------------------------------
  127.           
  128.           
  129.           Pitch or Yaw button (i.e., CTRL-rightarrow). Stop the
  130.           spinning plot by pressing a Roll, Pitch or Yaw button
  131.           (without CTRL). Select a Grow or Shrink (+ or -) option to
  132.           cause the points in the plot to expand from the center of
  133.           the plot, or contract toward the center of the plot. Select
  134.           to increase or decrease (>> or <<) the degree of each move.
  135.           This is particularly useful to control the speed of a
  136.           spinning plot. Select Home to return the plot to its home
  137.           Roll, Pitch and Yaw position, and to return the degree move
  138.           to its default value.
  139.           
  140.           At the top of the plot is a menu bar containing the following
  141.           options:
  142.           
  143.           o Exit the plot
  144.           
  145.           o Print the plot to the printer. (If supported on your
  146.           computer)
  147.           
  148.           o Cap/PCX - Capture the plot as a PCX file. (This option
  149.           only works in EGA and VGA modes)
  150.           
  151.           o Get colors - displays another menu -- which allows you to
  152.           choose to display the plot in black and white or choose
  153.           other colors for the background, graph and text and return
  154.           to the main plot menu.
  155.           
  156.           o Display Help.
  157.           
  158.           o Display the options menu.
  159.           
  160.           If you choose the Option menu from the main Spin plot menu
  161.           bar, a pick menu is displayed. The options menu has a number
  162.           of options you can choose. If an option is currently chosen,
  163.           a check will appear a the left of the option name. You can
  164.           select several options from the menu. Once you have chosen
  165.           the options you want, exit from the menu, and the plot will
  166.           be displayed using the selected options. From the options
  167.           menu, you may select these items:
  168.           
  169.           A) Display points with rays originating from the center of the
  170.              plot.
  171.           B) Display x, y, z axes.
  172.           C) Display a box around the points.
  173.           D) Display points as small dots
  174.  
  175.  
  176.  
  177.                                            3
  178.  
  179.  
  180.  
  181.  
  182.  
  183.           
  184.           KWIKSTAT 3D Scatterplot/SPIN
  185.           ----------------------------------------------------------
  186.           
  187.           
  188.           E) Display points a circles.
  189.           F) Display points as patterns (each group a different pattern)
  190.           G) Display rays within a box
  191.           H) Save the plot as a GRF file (to be replayed later).
  192.           I) Define a PRINT/PCX title for plot
  193.           X) Exit the options menu.
  194.           
  195.           Sometimes when you choose an option, that selection will
  196.           automatically select or deselect another option. For
  197.           example, if you choose to Display rays with a box, the
  198.           "Display a box around the points" is also automatically
  199.           selected, and the "Display x,y,z, axes" option is
  200.           automatically deselected.
  201.           
  202.           If you want to replay the plot later, first display the plot
  203.           using all of the options you want to save, then choose the
  204.           "Save the plot as a GRF file" option. See the next section
  205.           about redisplaying the plot from the GRF file.
  206.           
  207.           DISPLAYING A "3-D SCATTERPLOT" .GRF PLOT FROM DOS
  208.           
  209.           Once you have saved a .GRF plot description, you can  redisplay
  210.           this plot from the DOS prompt by using the
  211.           command
  212.           
  213.           KS3SPIN filename
  214.           
  215.           where filename is the name of a file (filename.GRF) that was
  216.           previously saved. The plot displayed will read the
  217.           information from the database originally used to create the
  218.           plot, and will display the plot including any options that
  219.           where chosen when the plot was originally displayed.
  220.           
  221.           This allows you to quickly display a plot you often need to
  222.           view, using .DBF file data that is updated periodically. For
  223.           example, if you need to view a plot from data that is
  224.           collected daily, weekly, etc. you can define the plot once
  225.           and save it as a .GRF file. Then, when the dBASE  (.DBF)
  226.           file is updated, you can enter the command described above
  227.           to display the plot from the new data.
  228.           
  229.           Sometimes, you may not want to retain all of the options you
  230.           have chosen from when the originally .GRF plot was created.
  231.           You can choose to tell the program to revert to default
  232.           values for the plot by using the /D option in the command.
  233.  
  234.  
  235.  
  236.                                            4
  237.  
  238.  
  239.  
  240.  
  241.  
  242.           
  243.           KWIKSTAT 3D Scatterplot/SPIN
  244.           ----------------------------------------------------------
  245.           
  246.           
  247.           For example, the command
  248.           
  249.           KS3SPIN filename /D
  250.           
  251.           will cause the .GRF file to be display as a default 3-D
  252.           scatterplot. You can control which defaults will be used by
  253.           placing a colon ":" and a code after the D in the /D option.
  254.           Each code (except one) is a 0 or 1, meaning 1= display the
  255.           selected item and 0=do not display the item. There are 8
  256.           codes. Here are their meanings:
  257.           
  258.            o Code 1 = Display rays from origin
  259.            o Code 2 = Display x,y and z axes
  260.            o Code 3 = Display large box around data
  261.            o Code 4 = Display points as dots
  262.            o Code 5 = Display points as circles
  263.            o Code 6 = Display points as patterns
  264.            o Code 7 = Display rays from the z-plane
  265.            o Code 8 = Spin the plot (can be 0,1,2,3,4,5 or 6)
  266.           
  267.           The code 8 options are defined as follows:
  268.           
  269.            o 0 = No spin
  270.            o 1 = Roll +
  271.            o 2 = Roll -
  272.            o 3 = Pitch +
  273.            o 4 = Pitch -
  274.            o 5 = Yaw +
  275.            o 6 = Yaw -
  276.           
  277.           For example, to display a plot named MYPLOT.GRF using all the
  278.           values as saved, you would use the command:
  279.           
  280.           KS3SPIN MYPLOT
  281.           
  282.           To display this plot, reverting to all defaults,  you could
  283.           use the command:
  284.           
  285.           KS3SPIN MYPLOT /D
  286.           
  287.           To display this plot with dots as patterns, you could use the
  288.           command:
  289.           
  290.           KS3SPIN MYPLOT /D:01000100
  291.           
  292.  
  293.  
  294.  
  295.                                            5
  296.  
  297.  
  298.  
  299.  
  300.  
  301.           
  302.           KWIKSTAT 3D Scatterplot/SPIN
  303.           ----------------------------------------------------------
  304.           
  305.           
  306.           Another option available on the command line is /P. This
  307.           allows you to cause the plot to automatically print once
  308.           displayed. For example, to display MYPLOT, and automatically
  309.           print the plot, use the command:
  310.           
  311.           KS3SPIN MYPLOT /P
  312.           
  313.           EXAMPLE SPIN PLOT
  314.           
  315.           The purpose of the Spin plot is to allow you to see your
  316.           data in a way that is not possible using a two dimensional
  317.           scatterplot. As an example, open the database file named
  318.           CAR, and select the following three fields for analysis:
  319.           
  320.           2) MPG (Miles Per Gallon)
  321.           6) Weight (Weight of the Car)
  322.           5) HP (Horsepower)
  323.           
  324.           For the grouping variable, choose
  325.           
  326.           3) Cylinders
  327.           
  328.           From the DOS prompt, you can display this plot (from a GRF
  329.           save file) by entering the command
  330.           
  331.           DEMOSPIN
  332.           
  333.           Or, you can manually create the plot from the Spin Plot
  334.           menu, by opening the CAR database and choosing the fields
  335.           MPG, WEIGHT and HP and the grouping variable CYLINDERS. The
  336.           initial plot that appears for this dataset was shown earlier
  337.           in figure S.3. To examine the relationships between the
  338.           variables, you should spin the plot on one or more axis to
  339.           view the relationships from different angles.
  340.           
  341.           The menu items at the right of the screen control the spin
  342.           plot. To access one of these items, either press command key
  343.           indicated (i.e. press the "Home" key on your keyboard to
  344.           reset the spin axes to their original position) or point to
  345.           one of the menu items with the mouse pointer and click. To
  346.           spin the plot, press the Ctrl key plus one of the six
  347.           direction keys. To stop the spin, press one of the direction
  348.           keys.
  349.           
  350.           You might also want adjust the scale of the plot by pressing
  351.  
  352.  
  353.  
  354.                                            6
  355.  
  356.  
  357.  
  358.  
  359.  
  360.           
  361.           KWIKSTAT 3D Scatterplot/SPIN
  362.           ----------------------------------------------------------
  363.           
  364.           
  365.           the + or - key (or clicking with the mouse). The scale of
  366.           the plot is designed so that the mean of each variable is
  367.           located at the intersection of the X, Y and Z axes.
  368.           
  369.           Since there is a grouping variable (Cylinders), datapoints
  370.           for each group appear in a unique color. If you are using a
  371.           monochrome monitor, or if you want to print the graph, you
  372.           will probably want to display the points using patterns. To
  373.           do this, choose <Options> from the top menu. You can choose
  374.           other options as you wish. When you exit the options menu,
  375.           the plot will be redisplayed using the options you have
  376.           chosen. The 3D Spin Options pick menu appears.
  377.           
  378.           From the options menu, choose to display the points as
  379.           patterns, then choose to Exit this option, and the spin plot
  380.           will be redisplayed.
  381.           
  382.           Display the CAR data with groups as patterns, and with the
  383.           axes tilted to show all three variables. From this angle,
  384.           you should be able to see that the larger cars (8 cylinder
  385.           cars are shown with an "X" symbol at the upper right of the
  386.           plot. This plot shows you that these large cars are at the
  387.           high end of the Y (Weight) variable, at the high end of the
  388.           Z (horsepower) variable and at the low end of the X (MPG)
  389.           variable. This is not a surprizing result, but it
  390.           illustrates how you can see patterns in the plot. You can
  391.           also see the clouds of points by grouping variable, showing
  392.           that this variable is a critical factor in determining miles
  393.           per gallon. That is, the fewer the number of cylinders (in
  394.           general) the higher the miles per gallon.
  395.           
  396.           
  397.           
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.                                            7
  414.  
  415.